home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / pcl / docs.lha / latex-CLTL-sty / more-info.txt / node19_mn.html < prev    next >
Text File  |  1991-07-02  |  2KB  |  78 lines
  1.  
  2. <H2><A ID="SECTION001101000000000000000">
  3. Constructs for Handling Multiple Values</A>
  4. </H2>
  5.  
  6. <P>
  7. Normally multiple values are not used.  Special forms are
  8. required both to <#2939#><I>produce</I><#2939#> multiple values and to <#2940#><I>receive</I><#2940#> them.
  9. If the caller of a function does not request multiple values,
  10. but the called function produces multiple values, then the first
  11. value is given to the caller and all others are discarded;
  12. if the called function produces zero values, then the caller gets <#2941#><#2941#>
  13. as a value.
  14.  
  15. <P>
  16. The primary primitive for producing multiple values is <#2942#>values<#2942#>,
  17. which takes any number of arguments and returns that many values.  If the
  18. last form in the body of a function is a <#2943#>values<#2943#> with three arguments,
  19. then a call to that function will return three values.  Other special
  20. forms also produce multiple values, but they can be described in terms of
  21. <#2944#>values<#2944#>.  Some built-in Common Lisp functions, such as <#2945#>floor<#2945#>, return
  22. multiple values; those that do are so documented.
  23.  
  24. <P>
  25. The special forms and macros for receiving multiple values are as follows:
  26. <BR>
  27. <tex2html_image_mark>#lisp2946#
  28. <BR>
  29. These specify a form to evaluate and an indication of where to put
  30. the values returned by that form.
  31.  
  32. <P>
  33. <BR>
  34. <tex2html_image_mark>#defun2948#
  35. <BR>
  36.  
  37. <P>
  38. <BR>
  39. <tex2html_image_mark>#defun2965#
  40. <BR>
  41.  
  42. <P>
  43. <BR>
  44. <tex2html_image_mark>#defun2970#
  45. <BR>
  46.  
  47. <P>
  48. <BR>
  49. <tex2html_image_mark>#defmac2980#
  50. <BR>
  51.  
  52. <P>
  53. <BR>
  54. <tex2html_image_mark>#defspec2988#
  55. <BR>
  56.  
  57. <P>
  58. <BR>
  59. <tex2html_image_mark>#defspec3000#
  60. <BR>
  61.  
  62. <P>
  63. <BR>
  64. <tex2html_image_mark>#defmac3009#
  65. <BR>
  66.  
  67. <P>
  68. <BR>
  69. <tex2html_image_mark>#defmac3021#
  70. <BR>
  71.  
  72. <P>
  73. <BR>
  74. <tex2html_image_mark>#new3042#
  75. <BR>
  76.  
  77. <P>
  78.